home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Languguage OS 2
/
Languguage OS II Version 10-94 (Knowledge Media)(1994).ISO
/
language
/
kaos
/
readme.ins
< prev
Wrap
Text File
|
1990-01-22
|
6KB
|
160 lines
##########################################################################
#
# INSTALLING KAOS
#
##########################################################################
SETTING KAOS ENVIRONMENTAL VARIABLES
#########################################################################
In order to install and run "kaos", you need to insert a few lines
into the files ".login" and ".cshrc" in your home directory.
(1) Include the environmental variable "KAOSHOME",
which is the top directory where kaos is currently installed.
(Ask the system manager or try to locate where the executable "kaos"
is in the system file hierarchy.)
For example, insert a line such as
setenv KAOSHOME ${HOME}/kaos
(2) Add the directories, ${KAOSHOME} and ${KAOSHOME}/bin,
to the search path. This ensures that you can run the program
kaos and its companion programs in any directory and make
future installation work.
For example, a line in .login and .cshrc should look like
set path = (${KAOSHOME} ${KAOSHOME}/bin other_directories...)
########################################################################
USING KAOS_INSTALL
########################################################################
Use the shell script "kaos_install" to set various flags
such as the top directory, the operating system type,
the printer name, the math flag, and the floating point coprocessor type
(1) Make sure first that ${KAOSHOME} environmental variable is set
as instructed in the previous section.
(2) Move to the directory ${KAOSHOME}.
(3) Type "kaos_install" and follow the instructions on the screen.
# NOTE: The existence of the file "installcap" is important. Do not edit
this file directly unless you are quite sure.
In case you edit the installcap file, make sure that information
in it is consistent with those in the files, Makefile, in various
kaos directories and in the kaos header files in the
directory ${KAOSHOME}/include.
##########################################################################
COMPILING AND LOADING KAOS WITH MAKEFILE
###########################################################################
If you have not defined ${KAOSHOME} in ".login" and ".cshrc", do so now.
If you have not run "kaos_install", do so now.
(1) Note that a default directory for the user-customized kaos ("kaos_u") is
set to ${HOME}/kaos in "Makefile" in the directory ${KAOSHOME}.
If you want to install "kaos_u" in another directory,
edit the variable KAOS_USER_DIR below.
(2) To make all the executables kaos needs, type
either "make all" if you are installing kaos from scratch
or "make all_u" if kaos is already installed on the system and you
want to make a local version of it with new dynamical systems.
To make the main executable only, type
either "make kaos",
or "make kaos_u"
To make a batch executable only, type
either "make kaos_batch"
or "make kaos_batch_u"
(This is necessary to send batch jobs.)
To make all the rest of executables in ${KAOSHOME}/bin,
type "make bin"
#######################################################################
INSTALLING A NEW DYNAMICAL SYSTEM
#######################################################################
Look up README file in the directory ${KAOSHOME}/userlib
########################################################################
ACCESSING THE SOURCE CODE PF BUILT-IN DYNAMICAL SYSTEMS IN DATABASE
########################################################################
Lookup README file in ${KAOSHOME}/modellib directory for more
information on how many vector fields and maps in our
dynamical system database are defined.
########################################################################
DESCRIPTION OF BUILT-IN DYNAMICAL SYSTEMS IN DATABASE
########################################################################
Lookup the files ${KAOSHOME}/modellib/*.info
########################################################################
CHANGING PARAMETERS OF DYNAMICAL SYSTEM CLASS
BUILDING A NEW DYNAMICAL SYSTEM CLASS
########################################################################
Lookup the file README ${KAOSHOME}/modellib
########################################################################
PORTING TO OTHER DIRECTORIES AND MACHINES
########################################################################
To port kaos to other directories or other machines with the same
architecture, one needs to make a copy of kaos source codes.
Use the command "kar" in $KAOSHOME/bin.
To create a tar file
--------------------
(1) Type "kar"
(2) After the prompt "Enter a tar file name:", type the name of tar file.
(3) You will see a list of copy options. Depending on your needs,
choose a proper option. (See the description on the screen for more info.)
To copy across the directories
------------------------------
Type "bin/kar -c" from $KAOSHOME.
Note that the size of kaos may be one's major concern becase of the
disc space constraint. Discard the groups of files you think are
less important. Typically the order of directories to go is:
archive
data
contriblib
companionlib
PS
RAS
doc
info
examples
Depending on one's need,
auto
graph
batch
kaos still would compile without all the above directories.
Theinstallation will be even faster if
one does not have to recompile the source codes.
Global change of C flags
------------------------
To remove the C debugging flags and optimize the compilation,
type
kedgr "-g" "-O" Makefile
After kaos has been mobe, rerun kaos_install to change the kaos
home directory.